Configure the Mart Server

To connect to the latest Mart, you must configure the Mart Server. Use the same database that you have used for the r9.0.0 Mart (or any earlier release of r9 series Mart).

Refer to the Upgrade Performance Considerations topic before proceeding.

Follow these steps:

From the Windows Start menu, click All Programs, erwin, erwin Mart Server 12.1 , Configure MartServer.
The erwin Mart Configuration dialog appears.

Configure the erwin Mart Server

Complete the following fields on the Mart Server tab:

Database Type: Specifies the database server type.
Port No.: Specifies the port number of the database server.
Server Name: Specifies the name of the database server where you have installed the Mart database. For example, suppose that you are using SQL Server as the Mart database. Enter the name of the computer where SQL Server is installed.
Instance Name: Specifies the name of the database instance.
Database Name

Specifies the name of the Mart database.

If you are installing the Mart for the first time, use a new database. Do not use an existing database that was created for r7.3 through r8.2.9 Mart.

If you are upgrading the Mart from any earlier release of r9 series to the latest release, use the corresponding Mart database. Also, for an Oracle mart, ensure that appropriate permissions for a materialized view are assigned to the installer role (GRANT CREATE MATERIALIZED VIEW TO MMINSTALL;). For more information, refer to the Prepare Your DBMS Environment topic.

User Name: Specifies the user name to connect to the Mart database. Enter the name of a user that is authenticated by the Mart database.

Windows authentication (User Name field) is not supported for connecting to the Mart database from the Configure Mart Server window.

Password: Specifies the password to connect to the Mart database.

The following fields--Domain Controller Name, Domain/User Name, and Password are required only if you are using the Active Directory authentication. You can use the Active Directory authentication to initialize the Mart and to log in to erwin Mart Administrator.

Domain Controller Name

Specifies the fully qualified name of the Active Directory Server (Domain Controller). Enter the name in the following format:

LDAP://server/distinguished-name
Example: ldap://mktgna:3268/dc=abc, dc=com

Here, mktgna is the server name. You can provide either the name of the server or the IP address. 3268 is the port number to which the server listens.

dc=abc, dc=com is the distinguished-name. The distinguished name is the full path of the object.

If you do not know the Domain Controller Name, use the Nltest command or talk to your System Administrator.

Domain/User Name

Specifies the domain name and user name in the <domain name>/<user name> format.

Password

Specifies the password of the domain user.

To validate connection for active directory, click Test.

Configure erwin Mart Administrator

Complete the following fields on the Mart Administrator tab:

Server Name

Specifies the name of the computer where the Web Server is present. For example, if you are using Tomcat, enter the name of the computer where Tomcat is installed.

Default: localhost

Port Number

Specifies the port number on which the Web Server is running.

Default: 18170

Application Name

Specifies the application name with which the Web Server is identified.

Default: MartServer

Secure Sockets Layer (SSL) Enabled

Specifies whether you want to connect to the Mart through a secured connection (SSL). Select this check box if you have implemented SSL.

If you use IIS with SSL, open server_ssl.xml file, which is available at C:\Program Files\erwin\Mart Server r9\Tomcat64\conf and un-comment Connector port="8009" protocol="AJP/1.3" allowedRequestAttributesPattern=".*" redirectPort="8443" secretRequired="false"/>.

Using a self-signed SSL certificate might result in an error about certificate authority while connecting to erwin Mart. In that case, click OK to continue connecting to erwin Mart.

Use IIS

Specifies whether IIS is used to run Mart Administrator. Select this check box only if you have configured IIS.

If you use IIS, open server.xml file available at C:\Program Files\erwin\Mart Server r9\Tomcat64\conf and un-comment <Connector port="8009" protocol="AJP/1.3" allowedRequestAttributesPattern=".*" redirectPort="8443" secretRequired="false"/>.

IIS Port

Specify the IIS port number that you want to use. This field is enabled only if you select the Use IIS check box. The default is 80.

Account Lockout Duration (Seconds)

Specify the duration (in seconds) for which an account should be locked whenever an incorrect password is entered five consecutive times. By default, it is set to five minutes (300 seconds). At the most, you can set it to 30 days (2592000 seconds).

Configure Advanced Settings

Only in case of failures in upgrade, before you rerun the upgrade, ensure that you select the following settings on the Advanced tab:

Rerun Count Upgrade: Specifies that the model count upgrade should run while running the Mart database upgrade.

Rerun Report Upgrade: Specifies that the report upgrade should run while running the Mart database upgrade.
Rerun Report Upgrade For All Models: Specifies that the report upgrade should run for all models while running the Mart database upgrade.

Ensure that the Mart database has the following:

m9reportUpgrade and m9ReportListData tables
m9Catalog table with entcnt, attcnt, relcnt, and countblob columns

Click Configure.
The Mart Server Upgrade dialog box appears.
Click Yes.

The MartUpgrade screen for count upgrade appears.

Once the count upgrade process is complete, the ReportExport screen appears.

This screen does not appear when you upgrade from 2020 R1 Mart to higher versions.

On completion of report export process, the upgrade process is complete. erwin Mart Administrator and the Mart Server are configured.